home *** CD-ROM | disk | FTP | other *** search
/ Sideface Sampler / Sideface Sampler.iso / menu / vpic / picem.doc < prev    next >
Encoding:
Text File  |  1994-01-17  |  14.4 KB  |  332 lines
  1.  
  2.  
  3.  PICEM is a general purpose picture view program which also allows you to
  4. adjust the brightness and contrast in your pictures and save them back out.
  5.  
  6.  PICEM is not shareware, it is freeware, meaning that you can copy and
  7. distribute PICEM on a non-profit basis (you cannot sell it). You may use
  8. PICEM to display images in a commercial circumstance. For instance you
  9. can use PICEM to show sample images at a trade show, or give away PICEM
  10. to show some example images in a book on fractals. But you cannot sell
  11. a book on "creating presentations with PICEM" and include PICEM (as a
  12. widely unlikely example (grin)). And you cannot sell a "Swimsuit Calendar"
  13. with PICEM as the engine which drives it.
  14.  
  15.  If you are unsure if your particular use of PICEM does not fall under
  16. the free-use description above, contact me for clarification.
  17.  
  18.  
  19.  .PIC    images are PC Paint and PICTOR images. PC Paint is published by MSC
  20.     tech, (previously named "Mouse Systems"). PICTOR is the Paint program
  21.     which is part of the GRASP package published by Paul Mace Software.
  22.  
  23.  .PCX    images are PC Paintbrush format images. PC Paintbrush is published
  24.     by Z-Soft.
  25.  
  26.  .GIF    images are Graphics Interchange Format, a generalized picture format
  27.     supported by Compuserve,  The PICS Series of Forums on Compuserve
  28.     is one of the best places to obtain an assortment of image files
  29.     including some stunning high resolution 256 color images (ideal
  30.     for VGA and SuperVGA cards).
  31.  
  32.  .TGA    images are Targa HiColor format images. Originally created for the
  33.         AT&T Targa series of video cards for IBMPC's. The two types of
  34.         Targa files PICEM accepts are Targa 16 files (which are actually
  35.         15 bits per pixel), and Targa 24 files.
  36.  
  37.  
  38. Keys available in PICEM when in the picture select list screen:
  39. -------------------------------------------------------------------------------
  40. Arrow keys  - scroll around picture list to select picture filenames
  41. SPACE       - mark/unmark image names for display
  42. *           - mark all image names for display
  43. RETURN      - display the current selected picture and any others selected
  44.               with SPACE
  45. ESC         - exit program
  46.  
  47.  
  48. Keys available in PICEM while viewing images:
  49. -------------------------------------------------------------------------------
  50. Arrow keys  - scroll around picture (if image is larger than screen)
  51. *           - reset to original contrast and brightness
  52. +           - increase contrast, (bring out colors in a flat image)
  53. -           - decrease contrast, (reduce washed-out dark colors in pale image)
  54. Ins         - increase brightness, (bring up details hidden in darkness)
  55. Del         - decrease brightness, (reduce the overexposed effect of a high
  56.               contrast setting)
  57. 1,2...8,9,0 - set speed for +,-,Ins and Del, (how fast contrast and brightness
  58.               controls function with 1 slowest and 0 fastest
  59. SPACE       - skip to the next picture selected
  60. RETURN      - exactly the same as SPACE
  61. TAB         - Scale image to exactly screen size (great for large images
  62.               that don't fit on screen, favorite of users of standard
  63.               VGAs that use mode W for viewing 640x480 images)
  64. W           - write picture to disk as BAS PIC GIF PCX or IMG
  65. BACKSPACE   - display test pattern (in 256 color modes only)
  66. ESC         - exit program
  67.  
  68.  
  69. Command line Parameters for PICEM
  70. -------------------------------------------------------------------------------
  71.  
  72. PICEM {/k /l /w:t /v:vmode{,xsize,ysize,vnum} /d:x,y /m /c} fname ...
  73.  
  74. /k          - do not wait for a keypress between pictures
  75.  
  76. /l          - display pictures in continous loop
  77.  
  78. /s          - scale all images to screen size (like TAB key)
  79.  
  80. /w:t        - Wait t number of 1/100ths of a second after each picture
  81.  
  82. /n          - Don't sort list of filenames
  83.  
  84. /e          - Don't clear screen on exit (leave image on screen)
  85.  
  86. /d:x,y      - set lower left hand coordinates to display picture
  87.  
  88. /d          - force centering of image (default)
  89.  
  90. /m          - multi-picture display prevents palette switch between
  91.               display of multiple images
  92.  
  93. /c          - clear the screen
  94.  
  95. /v:vnum
  96.       vnum  - BIOS video mode number to set (vmode defaults to 'L')
  97.               this is the short order version of the full /v: option
  98.               it is intended for SuperVGA modes.
  99.  
  100. /v:vmode{,xsize,ysize,vnum}
  101.       vmode - video mode most similar to the mode you are choosing:
  102.  
  103. A   CGA 4 color                         B   PCjr/Tandy 16 color                         
  104. C   CGA 640x200 2 color                 D   EGA 640x200 16 color                         
  105. E   EGA 640x350 2 color                 F   EGA 640x350 4 color                         
  106. G   EGA 640x350 16 color                H   Hercules 720x348 2 color                         
  107. I   VGA 640x350 16 color                J   EGA 320x200 16 color                         
  108. K   AT&T/Toshiba 640x400 2 color        L   VGA/MCGA 320x200 256 color                         
  109. M   VGA 640x480 16 color                N   Hercules InColor 720x348 16 color                         
  110. O   VGA/MCGA 640x480 2 color            P   EGA/VGA 800x600 2 color                         
  111. Q   EGA/VGA 800x600 16 color            R   S-VGA 640x400 256 color                         
  112. S   S-VGA 640x480 256 color             T   S-VGA 800x600 256 color                         
  113. U   S-VGA 1024x768 2 color              V   S-VGA 1024x768 16 color                         
  114. W   VGA 360x480 256 color               X   S-VGA 1024x768 256 color                         
  115. Y   S-VGA 1280x1024 16 color            Z   S-VGA 1280x1024 256 color                         
  116. L1  S-VGA 320x200 HiColor 15            S1  S-VGA 640x480 HiColor 15                         
  117. T1  S-VGA 800x600 HiColor 15            X1  S-VGA 1024x768 HiColor 15                         
  118. Z1  S-VGA 1280x1024 HiColor 15          L2  S-VGA 320x200 HiColor 16                         
  119. S2  S-VGA 640x480 HiColor 16            T2  S-VGA 800x600 HiColor 16                         
  120. X2  S-VGA 1024x768 HiColor 16           Z2  S-VGA 1280x1024 HiColor 16                         
  121. L3  S-VGA 320x200 HiColor 24            S3  S-VGA 640x480 HiColor 24                         
  122. T3  S-VGA 800x600 HiColor 24            X3  S-VGA 1024x768 HiColor 24                         
  123. Z3  S-VGA 1280x1024 HiColor 24
  124.  
  125.       xsize - optional width of the video mode you have chosen in pixels
  126.       ysize - optional height of the video mode you have chosen in pixels
  127.       vnum  - the BIOS video mode number for the mode you have chosen
  128.  
  129.  
  130. Other command line options:
  131.  
  132. /vesa       - Only test for VESA VBE support, do not do any low level
  133.               SVGA chipset detect (which can cause problems on some
  134.               video cards).
  135.  
  136. /nosvga     - Disable all SVGA testing/support including VESA VBE support.
  137.               This option may be required on old or unusual hardware which
  138.               may react badly to SVGA detect or even the VESA Video Bios
  139.               Extensions detect call.
  140.  
  141. /biospal    - Forces PICEM to use the standard Video BIOS function call for
  142.               setting the VGA color palette. This may be required on some
  143.               Local Bus video card that do not handle high speed direct
  144.               writes to the palette RAMDAC. The symptom is generally random
  145.               errors in the image (some colors are wrong). This can also
  146.               happen on some early VGA clones which had bugs in their palette
  147.               support.
  148.  
  149. /novesa     - Disables all VESA VBE support, this is mainly for cards with
  150.               built in VESA support that is broken or flawed. In particular
  151.               some laptops.
  152.  
  153. /noems      - Disable use of EMS for swapping
  154.  
  155. /noxms      - Disable use of XMS for swapping
  156.  
  157. /nodisk     - Disable use of a Read/Write Swapfile on the current drive.
  158.  
  159.  
  160.  PICEM accepts wildcard filenames, so you could:
  161.  
  162.         PICEM \PICS\*.GIF
  163. or
  164.  
  165.         PICEM /V:W /W:50 \CIS\*.GIF
  166.  
  167. or
  168.         PICEM /V:L /K /D:20,30 FRAME??.PIC
  169.  
  170. or
  171.         PICEM /V:S1 *.TGA
  172.  
  173.  
  174.  PICEM supports a wide variety of Video boards, with a primary emphasis on
  175. VGA/SuperVGA boards.  On VGA boards PICEM defaults to /V:W which is
  176. 360x480 256 colors (a non-standard mode, but it's the best 256 color mode
  177. available on a standard VGA). On SuperVGA boards PICEM defaults to /V:R
  178. which is 640x350/640x400 256 colors on boards with only 256k, and /V:S
  179. which is 640x480 256 colors on boards that have 512k or more.
  180.  Some boards such as the ATI and Orchid may be capable of 800x600 256
  181. colors, but since many monitors will not handle this mode, I don't
  182. default to it, you can manually select it with /V:T.
  183.  Also if your board has a odd resolution 256 color mode that you would like
  184. to take advantage of (such as the Everex 512x480 mode, or the Genoa 720x512
  185. mode) you can manually override the BIOS mode used. For instance to set
  186. 512x480 on a Everex  board we would do PICEM /V:0x15 (the 0x means hexidecimal,
  187. the way most bios mode numbers are written in manuals, the same number in
  188. decimal would be PICEM /V:21).
  189.  
  190.  For any bug reports I can be contacted on CIS (Compuserve) ID:75300,2137 in
  191. the PICS Forum, To enter the PICS forum on Compuserve just type "GO PICS"
  192. from any prompt.
  193.  
  194.  
  195. John Bridges  1/17/1994
  196.  
  197.  
  198.  
  199. Bug fixes:
  200.  
  201. 10/09/91 -   /d:0,0 will now work (it used to center the image)
  202.  
  203. 10/11/91 -   /d with no colon resets to centering images
  204.              and the /d: and /d parm can be mixed with filenames
  205.              to display images at different positions.
  206.  
  207. 10/12/91 -   oops, the multiple /d: and /d parms were skipping
  208.              filenames.
  209.  
  210. 10/14/91 -   /c is new command line option to force screen to clear.
  211.              /m is new command line option to prevent palette change
  212.              between images.
  213.          the first /d: and /d parms MUST be just before the
  214.              first filename after all other parms. This applies
  215.              to all parms that can be mixed in with filenames
  216.          (right now this is /d: /d /c and /m).
  217.              @filename on the command line allows a list of command
  218.              line parms to be read it from a file.
  219.          New tiny version of picem called TPICEM.EXE is now
  220.              available. It removed the image selection screen, the
  221.              palette manipulation (brightness/contrast), the test
  222.              screen, the help screens and the image save.
  223.  
  224. 10/19/91 -   support for OAK Tech OTI-077 chipset is in
  225.       
  226. 10/24/91 -   better accuracy and overflow checking in brightness and
  227.              contrast control code, it's completely rewritten, much
  228.              smoother.
  229.  
  230. 10/25/91 -   * key selects all pictures when in picture list display.
  231.  
  232.  1/20/92 -   new version number because support for ACUMOS and ATI are
  233.              added, and some other library bugs are fixed.
  234.  
  235.  1/24/92 -   GIF load code corrected to handle extension blocks at the
  236.              beginning of images.
  237.  
  238. 10/26/92 -   I removed the long list of chipset makers and video mode
  239.              numbers. This information is still available in VGAKIT.
  240.  
  241.  6/25/93 -   Rewritten to use new virtual memory system I created for
  242.              Multi-Media GRASP 5.0
  243.  
  244.              EMS/XMS and disk swapping support
  245.  
  246.              HiColor video modes (15 and 16 bit)
  247.  
  248.              New 32bit bitblit code (on 386/486 processors)
  249.  
  250.              High speed scaling
  251.  
  252.              Uncompressed Targa and TIFF images support
  253.  
  254.              Better support of odd text modes (VESA VBE ones in particular)
  255.  
  256.       
  257.  7/20/93 -   New command line options to control EMS/XMS/Disk swapping.
  258.  
  259.              New command line options /NOSVGA, /VESA, and /BIOSPAL
  260.      
  261.              Support for automatic conversion of 256 color for display in
  262.              HiColor modes (including scaling).
  263.  
  264.              Auto conversion of 24 bit, 16 bit and 15 bit images to any
  265.              HiColor mode (including scaling).
  266.  
  267.              New hispeed scaling code for HiColor video modes.
  268.  
  269.              HiColor images can be displayed in 256 color modes, there is
  270.              a slight delay while the lookup table is generated, and
  271.              the current palette is used (which is useually not an optimum
  272.              palette).
  273.  
  274.              List of modes in help is now limited to detected available
  275.              video modes (making the list more readable, and allowing
  276.              HiColor modes to be listed).
  277.  
  278.  7/20/93 -   Fixed 256 color display of Hicolor 16 and 24 bit images, and
  279.              sped up scrolling/scaling of Hicolor images in 256 color mode.
  280.  
  281.  7/21/93 -   VGA 16 color modes weren't working in 3.01 and 3.01b, ooops.
  282.  
  283.  7/25/93 -   Display of GIF's in HiColor modes was not working
  284.  
  285. 10/08/93 -   New command line switch /NOVESA (mainly for broken vesa vbe
  286.              drivers on chipsets that PICEM can detect, like Western Digital).
  287.  
  288.              Line width reprogramming disabled, this slows down picem
  289.              slightly, but fixes problems on Diamond and ATI boards in
  290.              HiColor modes (and a few other modes).
  291.  
  292.              Bug in GIF save fixed (it was leaving off a pixel on the top line)
  293.  
  294.              /BIOSPAL option now works correctly
  295.  
  296.              PCX Save fixed and made faster
  297.  
  298.              Assorted other HiColor speedups including translation of images
  299.              made in almost any other mode to HiColor modes.
  300.  
  301. 10/13/93 -   64k color mode set fixed, it was actually setting 32k color mode.
  302.  
  303.  1/17/94 -   24bit PCX and TIFF load support added
  304.  
  305.              Serveral memory manager fixes, and speedups
  306.  
  307.              Serveral bugs in 24 bit modes fixed including text at bank
  308.              crossings
  309.  
  310.              Upsidedown Targa files support added
  311.  
  312.              Video modes F and N are removed
  313.  
  314.              Mode 'F' is really only for 64k EGA cards, and mode 'N' is only
  315.              for the hercules made InColor card which was meant to compete
  316.              with EGA, but arrived shortly before VGA.
  317.  
  318.              Mode 'B' is still supported for Tandy machines, but it will be
  319.              the next orphaned video mode.
  320.  
  321.              New command line option /NO386 which disables all 386/486 specific
  322.              code including 32bit read/writes to video ram.
  323.  
  324.              32bit reads/writes to video ram are now disabled on trident
  325.              based video cards in all 2 and 16 color video modes.
  326.  
  327.              Some 386 specific code was possibly being executed on 286 and
  328.              8086 machines when loading GIF files.
  329.  
  330.  
  331.  
  332.